Changes the current setting of a control and redraws it accordingly.

void SetControl32BitValue (
    ControlRef theControl, 
    SInt32 newValue
);

theControl

A handle to the control whose current setting you wish to change.

newValue

A value specifying the new setting of the control. If the specified value is less than the minimum setting for the control, SetControl32BitValue sets the current setting of the control to its minimum setting. If the specified value is greater than the maximum setting, SetControl32BitValue sets the control to its maximum.

DISCUSSION

Your application may use the SetControl32BitValue function to set a 32-bit value as the current setting for a control.

If your application uses a 32-bit control value, it should not attempt to obtain this value by calling the pre–Mac OS 8.5 function GetControlValue or by accessing the contrlValue field of the ControlRecord structure, because the stored 16-bit value will not accurately reflect the current 32-bit control value. Instead, use the function GetControl32BitValue.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)